home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / disk / misc / AutoMounter.readme < prev    next >
Text File  |  2002-10-13  |  10KB  |  206 lines
  1. Short:    AutoMount tool for any changeable disk drive
  2. Author:   tboeckel@uni-paderborn.de (Thore Boeckelmann)
  3. Uploader: tboeckel@uni-paderborn.de (Thore Boeckelmann)
  4. Type:     disk/misc
  5.  
  6. TITLE
  7.   AutoMounter
  8.  
  9.  
  10. VERSION
  11.   37.4
  12.  
  13.  
  14. AUTHOR
  15.   Thore Böckelmann <tboeckel@uni-paderborn.de>
  16.  
  17.  
  18. REQUIREMENTS
  19.   Any Amiga® (compatible) computer with at least OS2.04 and 68020+ cpu.
  20.  
  21.  
  22. DESCRIPTION
  23.   Did you ever have the problem, that you had several Zip® disks, each of them
  24.   probably formatted or partitioned differently with different filesystems like
  25.   FFS, SFS, PFS, CrossDOS, etc? And each time you change the disk you had to
  26.   mount another device driver to access the disk? Wouldn't it be much easier
  27.   just to insert the disk and let the Amiga automatically mount the new driver
  28.   if necessary?
  29.   Or do you have a disk drive, that cannot be accessed during booting, so that
  30.   you have to mount the drive "by hand" using a mountfile?
  31.   AutoMounter does exactly all these things. It will monitor any drive you
  32.   configure for disk changes. Every time you insert a disk in one of these
  33.   drives AutoMounter will check if the disk matches any of the already mounted
  34.   devices in the system, and if this check fails it will try to mount it. It
  35.   doesn't matter if the disk uses a filesystem you didn't use before, because
  36.   AutoMounter will try to read the disk's RDB and load the desired filesystem
  37.   from there. This also works for MS-DOS formatted disks, which have no RDB, but
  38.   it requires either CrossDOS or FAT95.
  39.   Please note that the CrossDOS/FAT95 support is very simple. Things like
  40.   partitions in extended partitions and similar things are not supported. I
  41.   think there is no need for such things because of two reasons:
  42.     1. most changeable media are Zip disks, which only have one partition
  43.     2. AutoMounter is no filesystem, just a little tool doing a job in the
  44.        background.
  45.   If you really ever have a disk with several partitions of which not all can be
  46.   mounted by AutoMounter, then please contact me and I will try to change that.
  47.  
  48.   A hint for IOBlix/VarIO users:
  49.   There is no need to specify the device entries in the tooltypes of AutoMounter
  50.   for parallel port Zip drives connected to the IOBlix/VarIO as long as you
  51.   start SetupIOBlix/SetupVarIO with the AUTOMOUNT option. IOBlix'/VarIO's
  52.   AutoMount.demon will use AutoMounter as soon as it is running. Without the
  53.   AutoMount.demon you will of course have to handle the drives connected to the
  54.   IOBlix/VarIO like any other device.
  55.  
  56.  
  57. USAGE
  58.   You can start AutoMounter from either Workbench or Shell with the following
  59.   options, although Workbench is more suitable:
  60.  
  61.   POLLTIMEOUT/K/N,FAT95/S,DEVICE/M
  62.  
  63.   POLLTIMEOUT/K/N: set the timeout (in seconds) for polling ancient drivers for
  64.     disk changes. Default value is 5 seconds.
  65.  
  66.   FAT95/S: use L:fat95 instead of L:CrossDOSFileSystem for MS-DOS formatted
  67.     disks. This is necessary, because the version of CrossDOS delivered with
  68.     AmigaOS 2.04+ doesn't support long filenames, but not everybody has FAT95
  69.     installed. So if you have MS-DOS formatted disk, but you don't own the
  70.     commercial version of CrossDOS (V6.x, V7.x), then set this option to use
  71.     FAT95.
  72.  
  73.   DEVICE/M: set a device to be monitored for disk changes. Each device entry
  74.     must be given using the following template:
  75.  
  76.     DEVICE/A,UNIT/A/N,MAXTRANSFER=MT/K,DEFFATNAME,POLL/S
  77.  
  78.     DEVICE/A: Exec style device name of the device to be monitored
  79.  
  80.     UNIT/A/N: unit number of the device
  81.  
  82.     MAXTRANSFER=MT/K: some devices don't like the standard value 0x00ffffff
  83.       for MaxTransfer. If you notice any problems then use this option. The
  84.       value must be given in hexadecimal notation, starting with "0x". Some
  85.       IDE/ATAPI drives will choke for other MaxTransfer values than 0x0001fe00.
  86.       Default value is 0x00ffffff.
  87.  
  88.     DEFFATNAME: MS-DOS formatted disks don't have an RDB, so they cannot tell
  89.       AutoMounter the name under which the drive should be mounted. This option
  90.       only affects MS-DOS formatted disks and has no meaning for Amiga formatted
  91.       disk with RDB. This name defaults to "FATC".
  92.       Note: This name must *NOT* include a trailing ":"!!
  93.  
  94.     POLL/S: use this option for those device drivers, that don't support disk
  95.       change notification. These drivers will be asked every <POLLTIMEOUT>
  96.       seconds for a disk change. This option should only be used if disk
  97.       changes are not noticed automatically.
  98.  
  99.     Examples:
  100.       DEVICE=cybppc.device 2
  101.       Monitor cybppc.device unit 2 (my Zip drive) for disk changes.
  102.  
  103.       DEVICE=cybppc.device 2 ZIPC
  104.       Monitor cybppc.device unit 2 for disk changes, but use ZIPC as drive name
  105.       for MS-DOS formatted disks. Usage of fat95 instead of CrossDOSFileSystem
  106.       for MS-DOS formatted disks depends on the global flag <FAT95>.
  107.  
  108.       DEVICE=very_ancient.device 0 FAT poll
  109.       Monitor very_ancient.device unit 0 for disk changes, use FAT as drive name
  110.       for MS-DOS formatted disks. Because very_ancient.device doesn't support
  111.       disk change interrupts, poll it every 5 seconds for a disk change. Usage
  112.       of fat95 instead of CrossDOSFileSystem for MS-DOS formatted disks depends
  113.       on the global flag <FAT95>.
  114.  
  115.   If you start AutoMounter from Shell you must surround every DEVICE
  116.   specification with quotes ("), because of the spaces in the specification
  117.   (e.g. AutoMounter "dev1.device 0" "dev2.device 4 poll")
  118.  
  119.   For the case you have two disks with different geometry, but with the same
  120.   device name in the RDB (for example two ZIP disks) AutoMounter will change the
  121.   name of the newly mounted device that it is unique in the system. That means
  122.   it will append ".0", ".1", ".2", etc to the RDB-saved device name, until the
  123.   device name is unique. You will have two different DOS-devices afterwards for
  124.   the same disk drive, but you will be able to access both disks without the
  125.   need of a remount tool like SCSIMounter or Mounter (supplied with OS3.5/3.9).
  126.   Additionally this behaviour is much safer than unmounting the old drive.
  127.  
  128.   You can start and quit AutoMounter at any time. To quit AutoMounter simply
  129.   start it a second time.
  130.  
  131.   Additionally there are three support tools for AutoMounter: AddAutoDevice,
  132.   RemAutoDevice and ListAutoDevices. With the first two tools you can
  133.   dynamically add or remove a device from disk change monitoring.
  134.  
  135.   The usage template for AddAutoDevice is the same as for every DEVICE tooltype
  136.   of AutoMounter. AddAutoDevice will print the result of adding the device for
  137.   monitoring, either success or failure.
  138.  
  139.   RemAutoDevice just needs the device name and the unit number to remove from
  140.   monitoring. RemAutoDevice will print the result of removing the device from
  141.   monitoring, either success or failure.
  142.  
  143.   ListAutoDevices will print a list of all currently monitored devices.
  144.  
  145.  
  146. INSTALLATION
  147.   Copy AutoMounter where ever you want, but SYS:WBStartup is a very good place.
  148.  
  149.  
  150. KNOWN BUGS
  151.   - cybppc.device seems to tend to crash after removing a device from
  152.     monitoring and changing the disk afterwards. I don't know why this happens
  153.     and if this applies for all of phase5's devices. But I think this not a real
  154.     problem, since all of phase5's devices have a built-in mounter, so there
  155.     should be no real need to run AutoMounter on these devices.
  156.   - 1230scsi.device (Blizzard 1230/1240/1260 SCSI module) doesn't increment its
  157.     diskchange counter. AutoMounter isn't affected by this anymore (V37.2), but
  158.     of course this is a serious bug in phase5's device drivers!
  159.  
  160.  
  161. HISTORY
  162.   37.1 (21.01.2001):
  163.     - initial Aminet release
  164.  
  165.   37.2 (12.02.2001):
  166.     - devices and units are now checked if they are changable media. Drives like
  167.       harddisks or CD-ROMs will be rejected, because they are either not
  168.       changable or they will never contain a valid RDB.
  169.     - recognition of MS-DOS formatted disks is much better now. MBR and
  170.       partition table are now searched for valid entries before trying to mount
  171.       a new device.
  172.     - new option FAT95 now enables support for fat95 filesystem instead of
  173.       CrossDOS.
  174.     - ListAutoDevices contained a wrong version string. Damn quick hacking :)
  175.     - drivers that need polling to detect a disk change will now get a command
  176.       sequence that is similar to the shell command DiskChange to make them
  177.       recognize the new disk.
  178.     - MaxTransfer value can be set now, in case some stupid device drivers
  179.       cannot handle transfers >=128K.
  180.     - mounting FAT formatted disks was completely broken and caused immediate
  181.       crashes. This is fixed now, CrossDOS and FAT95 are fully supported now.
  182.  
  183.   37.3 (23.08.2001):
  184.     - a device driver would have been opened over and over again when the disk
  185.       geometry could not be determinded for some reason. This is fixed now. Even
  186.       empty drives are monitored correctly now.
  187.     - IOBlix users should also replace the AutoMount.demon, because the old one
  188.       (37.17) just checked for AutoMounter 37.2, but not for newers releases.
  189.  
  190.   37.4 (10.10.2002):
  191.     - AutoMounter now tries to RemDevice() then device upon closure.
  192.     - if the newly inserted disk used a FileSystem that was not yet used by
  193.       any other device and delivered this FileSystem in its RDB the FileSystem
  194.       was never found. Fixed! (Chris Hodges <chrisly@platon42.de>)
  195.  
  196.  
  197. COPYRIGHT AND DISCLAIMER
  198.   AutoMounter is copyrighted 2001,2002 by Thore Böckelmann.
  199.   All rights reserved. This program is freeware, so no financial donations  
  200.   required. Redistribution allowed if the package is left unchanged. The author
  201.   is not responsible for any damage caused by the use or misuse of this
  202.   documentation and/or the program(s) it describes.
  203.  
  204.   AutoMounter uses the SmartReadArgs package by Thomas Aglassinger.
  205.   fat95 is (c)opyright by Torsten Jager <t.jager@gmx.de>
  206.